Power Programmierung/Power-Programmierung (Tewi)(1994).iso/assemblr/library/edit/e/e.doc

Text File | 1994-06-11 | 13KB | 276 lines

Thanks for downloading E!

E is a small, fast, general purpose editor.  It is copyrighted but you are
hereby granted a limited license to use it free of charge.  While I am not
aware of any bugs, I make no guarantees about its trustworthiness, so use it at
your own risk.  Feel free to share it with others.  I only ask that you
distribute these files together and unchanged and charge nothing for them (a
distribution fee of up to $15 is allowed).

Some of e's features:

  - block and line move and delete functions, to/from buffer or another file

  - find, replace, replace all

  - set tabs, L and R margins, word wrap, autoindent

  - set and jump to labels or line number

  - shell to DOS, one-key execution of batch files

  - DESQview-compatible (run in a window with direct write disabled)

  - assembly language (TASM) for speed and compactness, source included

  - configuration program included to change defaults


Lines are limited to 80 chars in length.  Longer lines in input files are
truncated.  Those entered at the terminal are wrapped at 80 characters.  Tab
characters encountered as a file is being read in are converted to spaces using
the current tab setting.

Here is a summary of commands.  In the descriptions of these commands, '*'
indicates that the function performs differently if the shift key is down.
When in E, press F1 for help.  Whenever you are asked to enter a response to a
prompt (as for a string to find or file name), just pressing Enter will usually
cancel the command.


Cursor movement:

left                      left arrow, Ctrl S
right                     right arrow, Ctrl D
word left                 Ctrl left arrow, Ctrl A
word right                Ctrl right arrow, Ctrl F
tab right                 Tab
tab left                  Shift Tab
to left margin            Home
to end of line            End
up                        up arrow, Ctrl E
down                      down arrow, Ctrl X
page up                   PgUp, Ctrl R
page down                 PgDn, Ctrl C
start of file             Ctrl PgUp
end of file               Ctrl PgDn
assign label (0-9)        Alt L
go to label (0-9)         Alt G
jump to line #            Alt J


Insert and Delete:

delete char left          backspace
delete char at cursor     Del
    Pressing delete when the cursor is to the right of all text on a line joins
    that line with the line below.
delete word left          Ctrl [
delete word right         Ctrl ]
delete to end of line     Ctrl \
delete line               Ctrl -, Ctrl Y
undelete line             Ctrl ^
    'Delete to end of line' and 'delete line' save the deleted text in a
    buffer.  Use Ctrl ^ to retrieve one line at a time.  The same buffer is
    used for block deletes, providing an easy way to move a few lines:  delete
    the lines individually using Ctrl -, move the cursor to the new location,
    then insert all the lines at once using Alt I (see below).  If the cursor
    is at the left margin when a line is undeleted using Ctrl ^, the line is
    inserted above the current line.  If it is to the right of the left margin
    it overwrites what is currently on the line from that column on.  This is
    useful for moving comments from the end of one line to another.
toggle insert mode        Ins
    Toggle between Insert (the default, signified by a line cursor) and
    Overwrite (identified by a block cursor) modes of text entry.
insert raw character      Alt = *
    Insert the character which follows, which might otherwise be interpreted as
    a command (for example a form feed character).  If shifted, 80h is added to
    the character.  For example, to enter line drawing characters, press Shift
    Alt =, then a character in the set {@, A-J}.  Warning: don't start a line
    with a character whose ASCII value is > 80h (E uses that bit as a flag when
    moving buffered lines during a file swap).


Insert and Delete Block and File:

mark start of block       Alt B
copy block to buffer      Alt C *
delete block to buffer    Alt D *
insert block from buffer  Alt I *
empty block buffer        Alt E *
unmark                    Alt U
    Alt C copies all marked lines (between the line where you pressed Alt B for
    'mark start of block' and the present cursor location) to a buffer, or if
    the shift key is also down, to a file.  Alt D deletes the original lines
    after first copying them to the buffer or file.  Alt I inserts the contents
    of the file or buffer above the present line.  Press Alt I several times to
    insert multiple copies.  To move text, use Alt D then Alt I.  To move text
    between two files, delete or copy to the block buffer, press Alt O to
    change files, then Alt I to insert.  You can get lines into the buffer
    using either Alt C or Alt D or the line delete commands Ctrl - or Ctrl \
    and out using either Alt I or Ctrl ^.

    All block commands marked with a '*' will read from or write to a file
    instead of an internal buffer if the shift key is down (you will be
    prompted for a file name).  Here's a useful trick:  to print part of a
    file, first mark the start of the block with Alt B, then use Shift Alt C
    and give 'prn' as the file name.

    The block commands work on whole lines only.  To move part of a line, use
    the Enter key to break it into pieces first.


Formatting:

set left margin           Ctrl Home
set right margin          Ctrl End
    These toggle the margin settings between the current cursor location and the
    screen edge.
set tab width             Alt T
    E will expand all tabs found in files it edits.  If a file read in doesn't
    look right, change the tab width, then read the file in again by pressing
    Alt O and reentering the file name.
wrap paragraph            Alt W
    Readjust line lengths by moving words at the end up or down a line as
    necessary to best fill out the lines within the boundaries set by the left
    and right margins.  Wrapping will start at the beginning of the line the
    cursor is on and stop at the first line on which text does not begin at the
    left margin.  E automatically wraps text as you enter it, moving the first
    word that overflows the right margin down to the beginning of a new line.
toggle autoindent mode    Ctrl @
    Autoindent mode causes each new line after a carriage return to be indented
    as much as the line above it.  The default is on, the way you generally will
    want it for programming.  Turn it off for most word processing except
    writing outlines.
Toggle text/programming mode defaults   Alt Z
    Use this to change quickly between programming and text mode configurations.
    E starts in programming mode with margins at 0, 79 and autoindent on.  ALT
    Z toggles between this and margins at 8, 72 with autoindent mode off for
    processing text.  You may alter E to start up in text mode each time or
    change the default margins using the accompanying configuration program.


Find and Replace:

find                      Alt F *
replace                   Alt R *
find/replace all          Alt A *
    After pressing Alt F and entering a string to find, E will put the cursor
    at the start of the first exact match.  If you then press Alt R, you will
    be prompted for another string to replace the one just found.  Replace must
    always be used immediately after Find.  If the shift key is also pressed,
    the last string entered is used.  Use Find/Replace All only if you're sure
    you want to change all occurrances of a string.  Otherwise use shifted Find
    to locate each subsequent occurrence of a string, then shifted Replace only
    for those instances you want to replace.


Files and DOS:

load other file           Alt O *
    Alt O will save the current file if changed and prompt for the name of a
    new file to edit.  Shift Alt O will return you to the last file edited at
    the point you left off.  Repeatedly pressing Shift Alt O toggles back and
    forth between two files.
save and continue         Alt S
save and exit             Alt X
    Any time an attempt is made to save a file and the disk is full, E will let
    you know.  If you can't just change disks and try again (perhaps your hard
    disk is full), press Alt K, then F2 to shell to DOS, then delete some other
    files to make room.  Then type 'exit' to return to E, type Alt K again to
    mark the file to be saved and try the original command again.
toggle kill save on exit  Alt K
    Use Alt K before Alt X or Alt O to discard any changes made before exiting.
    Pressing Alt K again reinstructs E to save the file at exit.
shell to DOS              F2 *
execute EFn.BAT           F3-F6 *
    Press F2 to exit E temporarily to run some other file or system command
    (for example, DIR).  Type 'exit' after you are done to return to E.  If it
    exists, the batch file EFn.BAT will be executed when Fn is pressed, for n =
    3 to 6.  The file being edited will be saved first if changed.  You can use
    this feature to run a .BAT file to compile, link and/or debug the file you
    are editing, print the file, perhaps passing it to a print formatter such
    as NROFF first, even play a game if you are tired of working, all without
    losing your place!

    If the shift key is pressed along with the function key, E contracts itself
    down to under 7K, writing the file being edited to disk if changed, then
    reading it back in afterward.  Anything in the block or other buffers is
    lost.  Use this if the application which you are leaving E to run won't fit
    otherwise.

    For example, here is a .BAT file to invoke the Turbo assembler, linker and
    debugger.  If you name it 'EF3.BAT', it will be run whenever you push F3.
    '%1' will be replaced by the name of the file being edited minus any
    extension.

        echo off
        tasm -zi %1
        IF ERRORLEVEL 1 GOTO fixit
        tlink /v %1
        IF ERRORLEVEL 1 GOTO fixit
        td %1
        :fixit
        exit

    If you use one of these functions to invoke an assembler or compiler, I
    recommend you also install a program like BUFFIT to allow you to retrieve
    text that has scrolled off the top of the screen, so you can find those
    error messages once you are back in E.


I'd like to thank two people who have helped with this project.  Jim DeVries
wrote ECONFIG.EXE, with which you may change many of E's default settings.
Mike Robertson sent me the code to allow E to run under DESQview and
contributed many helpful suggestions as I was developing and debugging E.

I'd appreciate hearing about any bugs, and welcome any other comments.  To
contact me, leave mail to dnye on BIX or write me at the address below.  Please
enclose a stamped, self-addressed envelope if you write and want a reply.


                                                      David Nye MD
                                                      4209 W Lowe's Creek Rd.
                                                      Eau Claire, WI  54701
                                                      1 Feb, 1991
                                                      BIX name: dnye

Version history

0.2, 1 Jan 1990
    First widely released.

0.3, 20 Jan 1990
    Added F2 to execute a DOS command, Alt Z as a quick way to set up word
    processing defaults.  Clearer help screen.  ESC no longer exits (I kept
    hitting it by mistake).  Use Alt X instead.  Some minor bug fixes.  Added
    more color monitor support (default colors, cursor fix).

0.4, 28 Jan 1990
    More bug fixes (last line in file no longer has CR LF appended, can no
    longer start e up without a file name on the command line, then escape out
    of entering a file name at the prompt).  There is now a byte settable with
    debug to start e up in text mode instead of programming mode.  Can enter
    chars above 80h with Shift Alt =.  Wrapping a line ending in one of the
    punctuation characters in the set {.;:!?} leaves two spaces after the
    character.

0.5, 15 Feb 1990
    More minor bug fixes.

0.6, 28 Feb 1990
    Added ability to run under DESQview and F3-F6 functions (to execute BATs).

1.0, 15 Mar 1990
    Bug fixes.  Added shifted F2-F6 functions.

1.1, 7 July 1990
    More bug fixes.  Now works under older (v. 2.?) DOS, recognises disk full.

1.2, 12 Oct 1990
    Minor bug fixes.

1.3, 1 Feb 1991
    Added Shift Alt O command to return to last file edited.  The lower of two
    lines joined by pressing delete at the end of the upper line now has leading
    spaces deleted.